Toolbox Reference

On the left side of the Scripter Page Editor window, click on the Toolbox tab. This provides a selection of controls that may be used on the agent screen to convey information to and receive from the agent (Fig. 1).

Fig. 1 - Toolbox

Fig. 1 is taken from V10.6.229.

Some of these controls, such as Label and Image are purely presentational; others, such as Button and Selection allow the agent to input information to control the script flow.

To create a control on the screen:

Double click the required control in the toolbox
The control can then be dragged to the required position

Each control has a number of properties which can be set to alter the appearance or behaviour of the control. Properties which are

particular to a small number of controls are described in the topic for each control
common to (almost) all controls are listed below

Common Properties

Property	Description	Applies to...
Height	The height of the item in pixels	All controls
IsEnabled	Whether the user can interact with the item or not
Language	The language used by items which have a standard self-contained UI. The example below (Fig. 2) shows the DateTimeEditor control (which uses the Microsoft Calendar control and supports the language property) with the Language property set to Chinese: Fig. 2 - Language Property
Margin	Effectively the position of the item. The property has 4 number fields; only the first 2 are used, to control the horizontal and vertical pixel distance of the top left corner of the item, from the top-left corner of the grid. To move the item, either drag it. Note that the property values are not dynamic. To see the new values, click away from the item; then reselect it. enter integers into the property fields. The position of the item is dynamic and reflects the new value immediately.
Name	The item identity, as an aid to design. Useful when there are many items on the grid. Each item name is visible when viewing using the Outline tab. Names are not required to be unique, but it may be helpful to make them so.
Visibility	Whether or not the item is displayed when the script is run. Select from: Visible (default) - displayed when run Hidden - not displayed when run, but space reserved for it in layout Collapsed - not displayed when run, and space not reserved for it in layout Hidden and Collapsed also hide the item in design view. To select a hidden/ collapsed item, either: drag over the area in which it sits. The drag must enclose the entire control. In Outline view, click on the item in the tree
Width	The height of the item in pixels
FontFamily	The font family (e.g. Arial, Verdana, etc) used for the visible text. To set the font family, select from the drop-down, showing all fonts installed on the current (designer) system. Note that although all installed fonts are shown, care should be taken to select a font which is available on the system where the script will be run. The final four font families listed are: Global User Interface Global Monospace Global Sans Serif Global Serif These are provided as safe, universally available classes of font. The standard HTML fallback list approach (e.g. Arial, Helvetica, sans-serif) is not supported. If the selected font is not available, the default fallback font family (Global User Interface) is used.	All controls except Ellipse and Rectangle
FontSize	A positive integer indicating the pixel size of the font. No CSS variants (e.g. em, pt, small) are allowed. Accepted values are 1 and greater. Default is 12
FontStyle	The style of the font used for the visible text. Select from: Normal (default) Oblique (i.e. extreme italic) Italic
FontWeight	Select from: Normal (default) Bold
Foreground	The colour of any visible text. Select from Default Colors or specify precisely using More Colors
Background	The colour of the background of the control. Select from Default Colors or specify precisely using More Colors	All controls except Ellipse, Rectangle and Label
BorderBrush	The colour of the border of the item. Select from Default Colors or specify precisely using More Colors
BorderThickness	The pixel thickness of the border of the item. Accepted values are 0 to [Width or Height-1]. Default is 1. Fields are provided for each side of the item, so that each may be different, if desired. The fields, in order, specify left, top, right, bottom.
TabIndex	A positive integer defining the order in which controls are made in focus by hitting the Tab key on the keyboard. Accepted values are 0 to 2147483647 (default - maximum value for an integer)